Release 10.1A: Progress Fathom Replication
User Guide

DSRUTIL utility

Once you have initially set up, enabled, and started Fathom Replication, you can use the DSRUTIL utility to perform specific Fathom Replication server, Fathom Replication agent, source database, and target database requests.

Syntax

Operating system	Syntax
UNIX Windows	DSRUTIL db-name -C ACTION [Server|Agent] [name|ALL]

db-name

Database is the name of the database to perform the action on. The name of the database must be the first argument and must be a valid name.

-C action

The -C qualifier is used to specify the action to be performed on the database. You can supply the qualifiers described in Table 5–4.

Server | Agent

The action will be performed on the Fathom Replication server or the Fathom Replication agent.

name |ALL

The action will be performed on one Fathom Replication agent (name) or on all Fathom Replication agents (ALL). Each Fathom Replication server maintains a list of named Fathom Replication agents that it is communicating with. The agent name must be valid.

Table 5–4: DSRUTIL utility qualifiers 

Qualifier	Description
applyextent	Allows you to apply AI extents generated by the source directly to the target database.
canceldefer	Instructs the Fathom Replication server to stop attempting to reconnect.
connectagent	Instructs the Fathom Replication server to start one or both of its configured agents.
disablesitereplication	Allows you to disable Fathom Replication while the source database is online.
monitor	Displays a PROMON-type series of screens that show the current state of replication.
recovery	Displays the replication recovery information.
relwaits	Frees up any pending waits that might be outstanding so that database activity can continue.
restart	Restarts the Fathom Replication server.
startagent	See connectagent.
terminate	Terminates the currently running Fathom Replication server or agent.
transition	Instructs a Fathom Replication agent to transition a replication-enabled database.
triggertransition	Forces the target database to go into a pre-transition state.

You can use the following command actions and modifiers with the DSRUTIL utility.